home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 July / EnigmA AMIGA RUN 20 (1997)(G.R. Edizioni)(IT)[!][issue 1997-07 & 08][EAR-CD IV].iso / earcd / mus / play / splibdev.lha / superplay-lib_DEV / Programmers / autodocs / SuperPlay_Ref_GER.doc < prev    next >
Text File  |  1997-04-03  |  19KB  |  736 lines
  1.  
  2. TABLE OF CONTENTS
  3.  
  4. superplay.library/--background--
  5. superplay.library/SPL_AllocHandle
  6. superplay.library/SPL_FreeHandle
  7. superplay.library/SPL_StopReplay
  8. superplay.library/SPL_FreeResources
  9. superplay.library/SPL_SuperPlay
  10. superplay.library/SPL_SuperWrite
  11. superplay.library/SPL_InitHandleAsDOS
  12. superplay.library/SPL_InitHandleAsClip
  13. superplay.library/SPL_SetWriteType
  14. superplay.library/SPL_GetErrorString
  15. superplay.library/SPL_SetWriteName
  16. superplay.library/SPL_FileInfoRequest
  17. superplay.library/SPL_SetReqIOWindow
  18. superplay.library/SPL_ReadPlayData
  19. superplay.library/SPL_ContinueReplay
  20. superplay.library/SPL_FastForward
  21. superplay.library/SPL_FastBackward
  22. superplay.library/SPL_GetSampleList
  23. superplay.library/SPL_SetSampleLisSet
  24. superplay.library/SPL_GetFileType
  25.  
  26.  superplay.library/--background--              superplay.library/--background--
  27.  
  28.    VERSION
  29.         $VER: SuperPlay_Ref_GER.doc V6.3 (3.4.97)
  30.  
  31.    COPYRIGHT
  32.         © 1995-97 by Andreas R. Kleinert. All rights reserved.
  33.  
  34.         - Feel free to translate this Doc-File into other languages. -
  35.  
  36.    GENERAL
  37.               Andreas R. Kleinert,
  38.               Sandstrasse 1,
  39.               D-57072 Siegen,
  40.               Germany.
  41.  
  42.         EMail:  Fido             Andreas Kleinert 2:2457/350.18
  43.                 Usenet/InterNet  Andreas_Kleinert@superview.ftn.neckar-alb.de
  44.  
  45.           If nothing else works, try one of these Fido-InterNet gateways:
  46.  
  47.                 Andreas_Kleinert@p10.f435.n2457.z2.fido.sub.org (in Germany)
  48.                 Andreas_Kleinert@p10.f435.n2457.z2.fidonet.org  (USA or other)
  49.  
  50.    HISTORY
  51.         V2     bug-fixed ClipBoard-Support
  52.                with the supplied SPObjects (ak)
  53.         V3     created working combination of
  54.                SPL_SetSampleList() and SuperWrite()
  55.                calls (ak)
  56.         V4     filetype recognition without loading (ak)
  57.         V4.6   Autodoc format
  58.                SetWriteName(): Correct type of write_name
  59.                Change two SVL_ prefix to SPL_
  60.                Add version behind NAME            (indy)
  61.         V5.1   SetWriteName() parameter must be UBYTE * (ak)
  62.         V5.2   add "()" to function names in text for better autodocs
  63.                support(indy)
  64.         V6.3   bumped version
  65.                updated copyright note
  66.                updated email address list (ak)
  67.  
  68.  
  69.  superplay.library/SPL_AllocHandle           superplay.library/SPL_AllocHandle
  70.  
  71.    NAME
  72.         SPL_AllocHandle -- Handle reservieren  (V1)
  73.  
  74.    SYNOPSIS
  75.  
  76.         APTR SPL_AllocHandle(APTR future)
  77.         D0   -$1e            A1
  78.  
  79.    FUNCTION
  80.  
  81.         Reserviert einen Handle zum Zugriff auf ein Sample/Module über
  82.         SPObjects.
  83.  
  84.    INPUT(S)
  85.  
  86.         future - derzeit immer NULL
  87.  
  88.    RESULT
  89.  
  90.         Ein Zeiger auf einen neu reservierten Handle oder NULL, falls
  91.         die Reservierung fehlschlägt.
  92.  
  93.    WARNING
  94.  
  95.         Überprüfe, ob das Ergebnis NULL oder ungleich NULL ist!
  96.  
  97.    SEE ALSO
  98.  
  99.         SPL_FreeResources(), SPL_FreeHandle()
  100.  
  101.  superplay.library/SPL_FreeHandle             superplay.library/SPL_FreeHandle
  102.  
  103.    NAME
  104.         SPL_FreeHandle -- Handle freigeben (V1)
  105.  
  106.    SYNOPSIS
  107.  
  108.         VOID SPL_FreeHandle(APTR handle)
  109.         D0   -$24           A1
  110.  
  111.    FUNCTION
  112.  
  113.        Beendet das Abspielen und gibt alle Ressourcen sowie den zuvor mit
  114.        SPL_AllocHandle() reservierten Handle frei.
  115.  
  116.    INPUT(S)
  117.  
  118.         handle - ein gültiger Handle
  119.  
  120.    RESULT
  121.  
  122.         -
  123.  
  124.    SEE ALSO
  125.  
  126.         SPL_AllocHandle(), SPL_StopReplay(), SPL_FreeResources()
  127.  
  128.  superplay.library/SPL_StopReplay             superplay.library/SPL_StopReplay
  129.  
  130.    NAME
  131.         SPL_StopReplay -- Beendet Abspielen des Samples/Modules  (V1)
  132.  
  133.    SYNOPSIS
  134.  
  135.         VOID SPL_StopReplay(APTR handle)
  136.         D0   -$2a           A1
  137.  
  138.    FUNCTION
  139.  
  140.         Beendet das Abspielen des mit den Handle angegebenen Sample/Module.
  141.         Einige SPObjects ermöglichen es das Sample/Module durch Aufruf
  142.         von SPL_ContinueReplay() weiter abspielen zu lassen, nachdem es
  143.         mit SPL_StopReplay() gestoppt worden ist.
  144.  
  145.    INPUT(S)
  146.  
  147.         handle - ein gültiger Handle
  148.  
  149.    RESULT
  150.  
  151.         -
  152.  
  153.    SEE ALSO
  154.  
  155.         SPL_ContinueReplay(), SPL_FreeResources(), SPL_FreeHandle()
  156.  
  157.  superplay.library/SPL_FreeResources       superplay.library/SPL_FreeResources
  158.  
  159.    NAME
  160.         SPL_FreeResources -- Freigabe nicht benötigter Ressourcen  (V1)
  161.  
  162.    SYNOPSIS
  163.  
  164.         VOID SPL_FreeResources(APTR handle)
  165.         D0   -$30              A1
  166.  
  167.    FUNCTION
  168.  
  169.         Gibt alle Ressourcen - des mit den Handle angegebenen Samples/Modules
  170.         frei - die nicht benötigt werden, um es einfach nur abzuspielen.
  171.         Das Abspielen des Samples/Modules wird weder gestoppt noch
  172.         unterbrochen.
  173.  
  174.    INPUT(S)
  175.  
  176.         handle - ein gültiger Handle
  177.  
  178.    RESULT
  179.  
  180.         -
  181.  
  182.    SEE ALSO
  183.  
  184.         SPL_AllocHandle(), SPL_StopReplay(), SPL_FreeHandle()
  185.  
  186.  superplay.library/SPL_SuperPlay               superplay.library/SPL_SuperPlay
  187.  
  188.    NAME
  189.         SPL_SuperPlay -- Lädt und spielt Sample/Module (V1)
  190.  
  191.    SYNOPSIS
  192.  
  193.         ULONG SPL_SuperPlay(APTR handle, char *filename)
  194.         D0    -$36          A1           A2
  195.  
  196.    FUNCTION
  197.  
  198.         Lädt und spielt das mit den Dateinamen spezifizierte Sample/Module
  199.         ab.
  200.         Das Handle wird initialisiert und das passende SPObject geöffnet
  201.         und zum Abspielen des Sample/Module verwendet.
  202.  
  203.         Das Abspielen kann entweder durch vollständige Freigabe des
  204.         Handles(SPL_FreeHandle()) beendet oder mit SPL_StopReplay()
  205.         unterbrochen werden.
  206.  
  207.    INPUT(S)
  208.  
  209.         handle   - ein gültiger Handle
  210.         filename - ein gültiger AmigaDOS Dateipfad und -name
  211.  
  212.    RESULT
  213.  
  214.         NULL oder eine SPERR-Fehlernummer.
  215.  
  216.    SEE ALSO
  217.  
  218.         SPL_AllocHandle(), SPL_StopReplay(), SPL_ContinueReplay(),
  219.         SPL_FastForward(), SPL_FastBackward(), SPL_FreeHandle()
  220.  
  221.  superplay.library/SPL_SuperWrite             superplay.library/SPL_SuperWrite
  222.  
  223.    NAME
  224.         SPL_SuperWrite -- Sample/Module speichern (V1)
  225.  
  226.    SYNOPSIS
  227.  
  228.         ULONG SPL_SuperWrite(APTR handle, APTR source_handle)
  229.         D0    -$3c           A1           A2
  230.  
  231.    FUNCTION
  232.  
  233.         Normalerweise wird ein Sample/Module mit SPL_SuperPlay() geladen
  234.         und abgespielt: Abgesehen von SPL_AllocHandle()/SP_FreeHandle() sind
  235.         hierzu sind keine weiteren Funktionsaufrufe zum Lesen und
  236.         Abpielen der Daten nötig.
  237.  
  238.         Zum Schreiben - also der Konvertierung eines Samples/Modules -
  239.         müssen folgende Funktionsaufrufe ausgeführt werden:
  240.  
  241.         source_handle = SPL_AllocHandle(N);
  242.         result        = SPL_ReadPlayData(source_handle, source_name);
  243.         dest_handle   = SPL_AllocHandle(N);
  244.         /* result     = SPL_InitHandleAsDOS(dest_handle, N); */ /* default */
  245.         result        = SPL_SetWriteName(dest_handle, dest_name, N);
  246.         result        = SPL_SetWriteType(dest_handle, dest_type, N);
  247.         result        = SPL_SuperWrite(dest_handle, source_handle);
  248.         SPL_FreeHandle(dest_handle);
  249.         SPL_FreeHandle(source_handle);
  250.  
  251.  
  252.         Wichtig: Überprüfe den "result" Wert NACH JEDEM Funktionsaufruf
  253.                  (siehe Beispiel Quellcodes) !
  254.  
  255.         Alle möglichen Werte für dest_type können in der SPOBject-List
  256.         der SuperPlayBase gefunden werden.
  257.         Diese Werte VERÄNDERN sich bei jeder Neuinitialisierung der
  258.         superplay.library, deshalb muß man sie bei jeden Öffnen der
  259.         Library erneut auslesen.
  260.  
  261.         WENN "source_handle" = NULL,
  262.         wird überprüft, ob eine SampeList mittels "SPL_SetSampleList()"
  263.         gesetzt worden ist wenn dies der Fall ist wird diese
  264.         SampleList komplett abgespeichert.
  265.  
  266.         Ein wird empfohlen den alten Weg zur Konvertierung zwischen
  267.         Dateiformaten und den neuen Weg zum Abspeichern einzelner(selbst
  268.         erstellter) SampleLists zu verwenden.
  269.  
  270.    INPUT(S)
  271.  
  272.         handle        - ein gültiger Handle          (zum Schreiben)
  273.         source_handle - ein anderer gültiger Handle  (zum Lesen)
  274.  
  275.    RESULT
  276.  
  277.         NULL oder eine SPERR-Fehlernummer.
  278.  
  279.    SEE ALSO
  280.  
  281.         SPL_AllocHandle(), SPL_ReadPlayData(), SPL_FreeHandle()
  282.  
  283.  superplay.library/SPL_InitHandleAsDOS   superplay.library/SPL_InitHandleAsDOS
  284.  
  285.    NAME
  286.         SPL_InitHandleAsDOS -- Initialisiert Handle für AmigaDOS  (V1)
  287.  
  288.    SYNOPSIS
  289.  
  290.         ULONG SPL_InitHandleAsDOS(APTR handle, APTR future)
  291.         D0    -$42                A1           A2
  292.  
  293.    FUNCTION
  294.  
  295.         Initialisiert den Handle für den Zugriff über AmigaDOS hierbei
  296.         wird der angegebene Dateiname benutzt.
  297.  
  298.         Eine andere Möglichkeit besteht darin den Handle für den
  299.         Clipboard Zugriff zu initialisieren(abhängig vom jeweiligen
  300.         SPObject, z.B. IFF-8SVX).
  301.  
  302.    INPUT(S)
  303.  
  304.         handle - ein gültiger Handle
  305.         future - derzeit immer NULL
  306.  
  307.    RESULT
  308.  
  309.         NULL oder eine SPERR-Fehlernummer.
  310.  
  311.    SEE ALSO
  312.  
  313.         SPL_InitHandleAsClip()
  314.  
  315.  superplay.library/SPL_InitHandleAsClip superplay.library/SPL_InitHandleAsClip
  316.  
  317.    NAME
  318.         SPL_InitHandleAsClip -- Initialisiert Handle für ClipBoard  (V1)
  319.  
  320.    SYNOPSIS
  321.  
  322.         ULONG SPL_InitHandleAsClip(APTR handle, APTR future)
  323.         D0    -$48                 A1           A2
  324.  
  325.    FUNCTION
  326.  
  327.         Initialisiert einen Handle für den Zugriff aufs Clipboard, dabei
  328.         wird ein (möglicherweise) angegebener AmigaDOS Datename ignoriert.
  329.  
  330.         Die beinahe fast immer benutze Möglichkeit besteht in der
  331.         Initialisierung des Handle zum AmigaDOS Zugriff(wird von
  332.         allen SPObjects unterstützt).
  333.  
  334.    INPUT(S)
  335.  
  336.         handle - ein gültiger Handle
  337.         future - derzeit immer NULL
  338.  
  339.    RESULT
  340.  
  341.         NULL oder ein SPERR-Fehlercode.
  342.  
  343.    SEE ALSO
  344.  
  345.         SPL_InitHandleAsDOS()
  346.  
  347.  superplay.library/SPL_SetWriteType         superplay.library/SPL_SetWriteType
  348.  
  349.    NAME
  350.         SPL_SetWriteType -- Schreibtyp setzen  (V1)
  351.  
  352.    SYNOPSIS
  353.  
  354.         ULONG SPL_SetWriteType(APTR handle, ULONG write_type, APTR future)
  355.         D0    -$4e             A1           A2                A3
  356.  
  357.    FUNCTION
  358.  
  359.         Setzt den Schreibtyp für einen SPL_SuperWrite() Aufruf.
  360.         Siehe dortige Beschreibung und Beispiel Quellcodes für weitere
  361.         und detailliertere Informationen.
  362.  
  363.    INPUT(S)
  364.  
  365.         handle     - ein gültiger Handle
  366.         write_type - ein gültiger - zeitlich begrenzter - write_type Code
  367.                      aus der SPObject List
  368.         future     - derzeit immer NULL
  369.  
  370.    RESULT
  371.  
  372.         NULL oder eine SPERR-Fehlernummer.
  373.  
  374.    SEE ALSO
  375.  
  376.         SPL_SuperWrite()
  377.  
  378.  superplay.library/SPL_GetErrorString     superplay.library/SPL_GetErrorString
  379.  
  380.    NAME
  381.         SPL_GetErrorString -- Liefert Fehlertext  (V1)
  382.  
  383.    SYNOPSIS
  384.  
  385.         char * SPL_GetErrorString(ULONG error_code)
  386.         D0    -$54                A1
  387.  
  388.    FUNCTION
  389.  
  390.         Liefert den Fehlertext für eine bestimmte Fehlernummer die
  391.         von einer der superplay.library Funktionen zurückgegeben worden
  392.         ist.
  393.  
  394.    INPUT(S)
  395.  
  396.         error_code - eine SPERR-Fehlernummer
  397.  
  398.    RESULT
  399.  
  400.         Nur-Lese Zeiger auf einen SPERR-Fehlertext
  401.  
  402.    SEE ALSO
  403.  
  404.         -
  405.  
  406.  superplay.library/SPL_SetWriteName         superplay.library/SPL_SetWriteName
  407.  
  408.    NAME
  409.         SPL_SetWriteName -- Dateinamen für SPL_SuperWrite() setzen  (V1)
  410.  
  411.    SYNOPSIS
  412.  
  413.         ULONG SPL_SetWriteNameClip(APTR handle, UBYTE *write_name, APTR future)
  414.         D0    -$5a                 A1           A2                 A3
  415.  
  416.    FUNCTION
  417.  
  418.         Setzt den Dateinamen für einen SPL_SuperWrite() Aufruf.
  419.         Siehe dortige Beschreibung und Beispiel Quellcodes für weitere
  420.         und detailliertere Informationen.
  421.  
  422.    INPUT(S)
  423.  
  424.         handle     - ein gültiger Handle
  425.         write_name - ein gültiger AmigaDOS Dateipfad und -name
  426.         future     - derzeit immer NULL
  427.  
  428.  
  429.    RESULT
  430.  
  431.         NULL oder eine SPERR-Fehlernummer.
  432.  
  433.    SEE ALSO
  434.  
  435.         SPL_SuperWrite()
  436.  
  437.  superplay.library/SPL_FileInfoRequest   superplay.library/SPL_FileInfoRequest
  438.  
  439.    NAME
  440.         SPL_FileInfoRequest -- Zeigt Informationen zum Sample/Module  (V1)
  441.  
  442.    SYNOPSIS
  443.  
  444.         ULONG SPL_FileInfoRequest(APTR handle, struct Window *window,
  445.         D0    -$60                A1           A2
  446.  
  447.                                   APTR future)
  448.                                   A3
  449.  
  450.    FUNCTION
  451.  
  452.         Gibt ein Infofenster mit mehr oder weniger detaillierten Informationen
  453.         über das derzeit geladene Sample/Module aus.
  454.         Es ist möglich einen Zeiger auf ein Fenster anzugeben mit dem
  455.         spezifiziert wird wo dieses Infofenster erscheinen soll.
  456.  
  457.    INPUT(S)
  458.  
  459.         handle - ein gültiger Handle
  460.         window - ein gültiger Fensterzeiger oder NULL
  461.         future - derzeit immer NULL
  462.  
  463.  
  464.    RESULT
  465.  
  466.         NULL oder eine SPERR-Fehlernummer.
  467.  
  468.    SEE ALSO
  469.  
  470.         SPL_SetReqIOWindow()
  471.  
  472.  superplay.library/SPL_SetReqIOWindow     superplay.library/SPL_SetReqIOWindow
  473.  
  474.    NAME
  475.         SPL_SetReqIOWindow -- Default Fenster für Dialogfenster setzen  (V1)
  476.  
  477.    SYNOPSIS
  478.  
  479.         ULONG SPL_SetReqIOWindow(APTR handle, struct Window *window)
  480.         D0    -$66               A1           A2
  481.  
  482.    FUNCTION
  483.  
  484.         Setzt ein Default-Fenster (default: IntuitionBase->FirstWindow)
  485.         für alle Dialogfenster.
  486.  
  487.    INPUT(S)
  488.  
  489.         handle - ein gültiger Handle
  490.         window - ein gültiger Fensterzeiger oder NULL
  491.  
  492.    RESULT
  493.  
  494.         NULL oder eine SPERR-Fehlernummer.
  495.  
  496.    SEE ALSO
  497.  
  498.         SPL_FileInfoReq
  499.  
  500.  superplay.library/SPL_ReadPlayData         superplay.library/SPL_ReadPlayData
  501.  
  502.    NAME
  503.         SPL_ReadPlayData -- Lädt Daten eines Samples/Modules  (V1)
  504.  
  505.    SYNOPSIS
  506.  
  507.         ULONG SPL_ReadPlayData(APTR handle, char *filename)
  508.         D0    -$6c             A1           A2
  509.  
  510.    FUNCTION
  511.  
  512.         Lädt die Daten eines mittels des Dateinamen spezifizierten
  513.         Samples/Modules aber spielt diese NICHT ab.
  514.         Das Handle wird initialisiert und das entsprechende SPObject
  515.         geöffnet, um mit SPL_SuperWrite() auf die Sample/Module Daten
  516.         zugreifen zu können.
  517.  
  518.    INPUT(S)
  519.  
  520.         handle   - ein gültiger Handle
  521.         filename - ein gültiger AmigaDOS Dateipfad und -name
  522.  
  523.    RESULT
  524.  
  525.         NULL oder eine SPERR-Fehlernummer.
  526.  
  527.    SEE ALSO
  528.  
  529.         SPL_SetWriteName(), SPL_SetWriteType(), SPL_SuperWrite()
  530.  
  531.  superplay.library/SPL_ContinueReplay     superplay.library/SPL_ContinueReplay
  532.  
  533.    NAME
  534.         SPL_ContinueReplay -- Abspielen fortsetzen  (V1)
  535.  
  536.    SYNOPSIS
  537.  
  538.         ULONG SPL_ContinueReplay(APTR handle)
  539.         D0    -$72               A1
  540.  
  541.    FUNCTION
  542.  
  543.         Einige SPObjects bieten die Möglichkeit das durch SPL_StopReplay()
  544.         unterbrochene Abspielen des Samples/Modules durch Aufruf
  545.         dieser Funktion fortzuführen.
  546.  
  547.    INPUT(S)
  548.  
  549.         handle - ein gültiger Handle
  550.  
  551.    RESULT
  552.  
  553.         NULL oder eine SPERR-Fehlernummer.
  554.  
  555.    SEE ALSO
  556.  
  557.         SPL_SuperPlay(), SPL_StopReplay()
  558.  
  559.  superplay.library/SPL_FastForward           superplay.library/SPL_FastForward
  560.  
  561.    NAME
  562.         SPL_FastForward -- Schnellvorlauf  (V1)
  563.  
  564.    SYNOPSIS
  565.  
  566.         ULONG SPL_FastForward(APTR handle)
  567.         D0    -$78            A1
  568.  
  569.    FUNCTION
  570.  
  571.         Einige SPObjects unterstützen die auch von Kassettenrecordern
  572.         bekannte Möglichkeit des Schnellvor- bzw. rücklaufs durch
  573.         ein Sample/Module.
  574.  
  575.    INPUT(S)
  576.  
  577.         handle - ein gültiger Handle
  578.  
  579.    RESULT
  580.  
  581.         NULL oder eine SPERR-Fehlernummer.
  582.  
  583.    SEE ALSO
  584.  
  585.         SPL_FastBackward()
  586.  
  587.  superplay.library/SPL_FastBackward         superplay.library/SPL_FastBackward
  588.  
  589.    NAME
  590.         SPL_FastBackward -- Schnellrücklauf  (V1)
  591.  
  592.    SYNOPSIS
  593.  
  594.         ULONG SPL_FastBackward(APTR handle)
  595.         D0    -$7e            A1
  596.  
  597.    FUNCTION
  598.  
  599.         Einige SPObjects unterstützen die auch von Kassettenrecordern
  600.         bekannte Möglichkeit des Schnellvor- bzw. rücklaufs durch
  601.         ein Sample/Module.
  602.  
  603.    INPUT(S)
  604.  
  605.         handle - ein gültiger Handle
  606.  
  607.    RESULT
  608.  
  609.         NULL oder eine SPERR-Fehlernummer.
  610.  
  611.    SEE ALSO
  612.  
  613.         SPL_FastForward()
  614.  
  615.  superplay.library/SPL_GetSampleList       superplay.library/SPL_GetSampleList
  616.  
  617.    NAME
  618.         SPL_GetSampleList -- Zugriff auf SampleList  (V2)
  619.  
  620.    SYNOPSIS
  621.  
  622.         ULONG SPL_GetSampleList(APTR handle, struct SPO_SampleList **list)
  623.         D0    -$84              A1           A2
  624.  
  625.    FUNCTION
  626.  
  627.         Während bzw. nachdem Laden einer Sample-Datei erstellen SPObjects
  628.         der Version 2 eventuell eine spezielle Liste aller Samples die in
  629.         dieser Datei enthalten sind.
  630.         Dies wird in der Regel bei einer Sample-Datei ein Sample sein
  631.         und eine ganze Reihe von Samples bei einen Module.
  632.  
  633.         Nicht alle SPObjects, speziell nicht alle ModuleType-SPObjects,
  634.         unterstützen dies und werden in diesen Fall eine Fehlernummer oder
  635.         eine leere SampleList als Ergebnis liefern.
  636.  
  637.    INPUT(S)
  638.  
  639.         handle - ein gültiger Handle
  640.         list   - ein Zeiger auf einen SPO_SampleList Zeiger
  641.  
  642.    RESULT
  643.  
  644.         NULL oder eine SPERR-Fehlernummer.
  645.  
  646.    SEE ALSO
  647.  
  648.         SPL_SetSampleList()
  649.  
  650.  superplay.library/SPL_SetSampleList       superplay.library/SPL_SetSampleList
  651.  
  652.    NAME
  653.         SPL_SetSampleList -- SampleList setzen  (V2)
  654.  
  655.    SYNOPSIS
  656.  
  657.         ULONG SPL_SetSampleList(APTR handle, struct SPO_SampleList *list)
  658.         D0    -$8a              A1           A2
  659.  
  660.    FUNCTION
  661.  
  662.         Zum Speichern von Sample-Dateien mit SPObjects der Version 2 kann
  663.         eine spezielle Liste aller Samples, die in dieser Datei erscheinen
  664.         sollen, verwendet werden.
  665.  
  666.         Dies wird in der Regel bei einer Sample-Datei ein Sample sein
  667.         und eine ganze Reihe von Samples bei einen Module.
  668.  
  669.         Nicht alle SPObjects, speziell nicht alle ModuleType-SPObjects,
  670.         unterstützen dies und könnten stattdessen ein
  671.         SPERR_ACTION_NOT_SUPPORTED als Fehler liefern.
  672.  
  673.    INPUT(S)
  674.  
  675.         handle - ein gültiger Handle
  676.         list   - ein Zeiger auf eine SPO_SampleList
  677.  
  678.    RESULT
  679.  
  680.         NULL oder eine SPERR-Fehlernummer.
  681.  
  682.    SEE ALSO
  683.  
  684.         SPL_GetSampleList()
  685.  
  686.  superplay.library/SPL_GetFileType           superplay.library/SPL_GetFileType
  687.  
  688.    NAME
  689.         SPL_GetFileType -- Liefert Dateitypen-Code  (V4)
  690.  
  691.    SYNOPSIS
  692.  
  693.         ULONG SPL_GetFileType(APTR handle, char *filename, ULONG *filetype)
  694.         D0    -$90            A1           A2              A3
  695.  
  696.    FUNCTION
  697.  
  698.         Findet den SuperPlay spezifischen Dateitypen-Code
  699.         (der bei jeder (neuen)-Initialisierung der Library neu definiert
  700.         wird) oder SP_FILE_TYPE_UNKNOWN (== NULL == FALSE).
  701.  
  702.         Benutzen Sie folgende Funktionsaufrufe für eine einfache Überprüfung:
  703.  
  704.         handle   = SPL_AllocHandle(N);
  705.         SPerr    = SPL_GetFileType(handle, filename, &filetype);
  706.                    SPL_FreeHandle(handle);
  707.  
  708.         Dieser Handle darf NICHT für weitere Operationen mit dieser
  709.         Datei benutzt werden(Datei wird einmal geöffnet und zweimal
  710.         überprüft aber nur einmal geschlossen, usw.)
  711.  
  712.         Initialisierungs Funktionen wie SPL_InitHandleAsClip() sind
  713.         gar nicht erlaubt.
  714.  
  715.         Wichtig, diese Funktion setzt nur die FILETYPES und nicht
  716.         die SUBTYPES. Zum Schreiben müssen sie z.B. diese SUBTYPES
  717.         spezifizieren.
  718.  
  719.         FILETYPES sind nur für eine einfache Idendifikation gedacht
  720.         und geben nur den allgemeinen Typ an(8SVX, ST).
  721.  
  722.    INPUT(S)
  723.  
  724.         handle   - ein gültiger Handle
  725.         filename - ein gültiger AmigaDOS Dateipfad- und -name
  726.         filetype - Zeiger auf ULONG für SP_FILETYPE-Wert
  727.  
  728.    RESULT
  729.  
  730.         NULL oder eine SPERR-Fehlernummer.
  731.  
  732.    SEE ALSO
  733.  
  734.         SPL_AllocHandle(), SPL_FreeHandle()
  735.  
  736.